import { get, post, postWithQueryParams } from "@/api/request";

/**
 * 整改单控制器 / 整改单控制器添加
 * @param {object} data
 * @param {string} [data.correctiveDeadline] 整改任务完成的截止日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.correctiveFormId] 整改单的编号
 * @param {string} [data.correctivePerson] 负责执行整改任务的具体人员
 * @param {string} [data.correctiveRequirement] 需要整改的具体要求或问题描述
 * @param {string} [data.correctiveUnit] 负责执行整改任务的单位或部门
 * @param {number} [data.delFlag] 删除标识
 * @param {number} [data.hasCorrectiveForm] 记录是否已生成整改单
 * @param {number} [data.id] id
 * @param {number} [data.qualityId] 巡检id
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<CorrectiveRequests页面展示实体>}
 */
export function correctiveRequestsAdd(data, config) {
  return post("/correctiveRequests/add", data, config);
}

/**
 * 整改单控制器 / 整改单控制器删除
 * @param {object} params
 * @param {object} data
 * @param {string} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<CorrectiveRequests页面展示实体>}
 */
export function correctiveRequestsDelete(params, data, config) {
  return postWithQueryParams("/correctiveRequests/delete", params, data, config);
}

/**
 * 整改单控制器 / 整改单控制器查询详情
 * @param {object} params
 * @param {string} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<CorrectiveRequests页面展示实体>}
 */
export function correctiveRequestsDetail(params, config) {
  return get("/correctiveRequests/detail", params, config);
}

/**
 * 整改单控制器 / 整改单控制器质量整改导出
 * @param {object} data
 * @param {string} [data.correctiveDeadline] 整改任务完成的截止日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.correctiveFormId] 整改单的编号
 * @param {string} [data.correctivePerson] 负责执行整改任务的具体人员
 * @param {string} [data.correctiveRequirement] 需要整改的具体要求或问题描述
 * @param {string} [data.correctiveUnit] 负责执行整改任务的单位或部门
 * @param {number} [data.delFlag] 删除标识
 * @param {number} [data.hasCorrectiveForm] 记录是否已生成整改单
 * @param {number} [data.id] id
 * @param {string} [data.inspectionEndDate] 质量巡检结束日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.inspectionResult] 检查结果
 * @param {string} [data.inspectionStartDate] 质量巡检开始日期 YYYY-MM-DD HH:mm:ss
 * @param {number} [data.length] 分页大小
 * @param {number} [data.orderAsc] 排序方向
 * @param {string} [data.orderColum] 排序字段
 * @param {number} [data.pageIndex] 分页下标
 * @param {string} [data.projectName] 项目名称
 * @param {number} [data.qualityId] 巡检id
 * @param {string} [data.qualityType] 巡检类型 可选值: QUALITY_INSPECTION, SAFETY_INSPECTION
 * @param {number} [data.start] 查询记录起始下标
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise}
 * @author 安奇
 */
export function correctiveRequestsExport(data, config) {
  return post("/correctiveRequests/export", data, config);
}

/**
 * 整改单控制器 / 整改单控制器生成整改单编号
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<string>}
 */
export function correctiveRequestsGenerateRectificationNumber(config) {
  return get("/correctiveRequests/generateRectificationNumber", config);
}

/**
 * 整改单控制器 / 整改单控制器分页查询
 * @param {object} data
 * @param {string} [data.correctiveDeadline] 整改任务完成的截止日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.correctiveFormId] 整改单的编号
 * @param {string} [data.correctivePerson] 负责执行整改任务的具体人员
 * @param {string} [data.correctiveRequirement] 需要整改的具体要求或问题描述
 * @param {string} [data.correctiveUnit] 负责执行整改任务的单位或部门
 * @param {number} [data.delFlag] 删除标识
 * @param {number} [data.hasCorrectiveForm] 记录是否已生成整改单
 * @param {number} [data.id] id
 * @param {string} [data.inspectionEndDate] 质量巡检结束日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.inspectionResult] 检查结果
 * @param {string} [data.inspectionStartDate] 质量巡检开始日期 YYYY-MM-DD HH:mm:ss
 * @param {number} [data.length] 分页大小
 * @param {number} [data.orderAsc] 排序方向
 * @param {string} [data.orderColum] 排序字段
 * @param {number} [data.pageIndex] 分页下标
 * @param {string} [data.projectName] 项目名称
 * @param {number} [data.qualityId] 巡检id
 * @param {string} [data.qualityType] 巡检类型 可选值: QUALITY_INSPECTION, SAFETY_INSPECTION
 * @param {number} [data.start] 查询记录起始下标
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<分页返回实体<CorrectiveRequestsPageVO页面展示实体>>}
 */
export function correctiveRequestsList(data, config) {
  return post("/correctiveRequests/list", data, config);
}

/**
 * 整改单控制器 / 整改单控制器更新
 * @param {object} data
 * @param {string} [data.correctiveDeadline] 整改任务完成的截止日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.correctiveFormId] 整改单的编号
 * @param {string} [data.correctivePerson] 负责执行整改任务的具体人员
 * @param {CorrectiveRecords创建传输实体} [data.correctiveRecordsDTO] 整改记录
 * @param {string} [data.correctiveRequirement] 需要整改的具体要求或问题描述
 * @param {string} [data.correctiveUnit] 负责执行整改任务的单位或部门
 * @param {number} [data.delFlag] 删除标识
 * @param {number} [data.hasCorrectiveForm] 记录是否已生成整改单
 * @param {number} [data.id] id
 * @param {number} [data.qualityId] 巡检id
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<CorrectiveRequests页面展示实体>}
 */
export function correctiveRequestsUpdate(data, config) {
  return post("/correctiveRequests/update", data, config);
}

/**
 * @template T
 * @typedef {Object} 分页返回实体
 * @property {T[]} content - 内容
 * @property {number} elementsNo
 * @property {number} limit
 * @property {number} number
 * @property {number} totalElements
 * @property {number} totalPages
 * @description 分页返回实体
 */

/**
 * @typedef {object} CorrectiveRecords创建传输实体 整改记录创建传输实体
 * @property {string} correctiveReply 整改回复内容
 * @property {number} correctiveRequestId 整改要求ID
 * @property {array<number>} fileIdList 附件id
 * @property {number} id
 * @description 整改记录创建传输实体
 */

/**
 * @typedef {object} CorrectiveRequests页面展示实体 页面展示实体
 * @property {string} correctiveDeadline 整改任务完成的截止日期
 * @property {string} correctiveFormId 整改单的编号
 * @property {string} correctivePerson 负责执行整改任务的具体人员
 * @property {string} correctiveRequirement 需要整改的具体要求或问题描述
 * @property {string} correctiveUnit 负责执行整改任务的单位或部门
 * @property {number} delFlag 删除标识
 * @property {number} hasCorrectiveForm 记录是否已生成整改单
 * @property {number} id id
 * @property {number} qualityId 巡检id
 * @description 页面展示实体
 */

/**
 * @typedef {object} CorrectiveRequestsPageVO页面展示实体 页面展示实体
 * @property {string} correctiveDeadline 整改期限
 * @property {string} correctiveFormId 整改单编号
 * @property {string} correctivePerson 整改人
 * @property {string} createUser 创建人
 * @property {number} id id
 * @property {string} inspectionDate 质量巡检日期
 * @property {string} inspectionItemName 检查事项名称
 * @property {string} inspectionNature 检查性质
 * @property {string} inspectionResult 检查结果
 * @property {string} inspectorName 巡检人员姓名
 * @property {string} projectId 项目id
 * @property {string} projectName 项目名称
 * @property {number} qualityId 巡检id
 * @property {string} recordId 整改记录id
 * @description 页面展示实体
 */
